home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr23 / hs121c5.zip / HSLINK.DOC < prev    next >
Text File  |  1993-12-29  |  102KB  |  2,304 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                               ▒▒▒▒▄ ▒▒▒▒▄   ▒▒▒▒▒▒▒▒▄
  8.                                ▒▒█▀  ▒▒█▀   ▒▒█▀▀▀▒▒█
  9.                                ▒▒█   ▒▒█    ▒▒█    ▀▀
  10.                                ▒▒▒▒▒▒▒▒█    ▒▒▒▒▒▒▒▒▄
  11.                                ▒▒█▀▀▀▒▒█      ▀▀▀▀▒▒█
  12.                                ▒▒█   ▒▒█    ▒▒▄   ▒▒█
  13.                               ▒▒▒▒█ ▒▒▒▒█   ▒▒▒▒▒▒▒▒█
  14.                                ▀▀▀▀  ▀▀▀▀    ▀▀▀▀▀▀▀▀
  15.  
  16.  
  17.  
  18.                                   H S / L i n k 
  19.  
  20.                                  High Speed Link 
  21.  
  22.                               File Transfer Protocol
  23.  
  24.  
  25.                                    Version 1.21
  26.                                   Revised 5/06/93
  27.  
  28.  
  29.         ___________________________________________________________________
  30.  
  31.          Please refer to HSLINK.NEW for details of recent program changes!
  32.         ___________________________________________________________________
  33.  
  34.      HS/Link  is a  high speed  file transfer  protocol with  full streaming,
  35.      simultaneous  send, receive and CHAT, and advanced Full-Streaming-Error-
  36.      Correction(tm).  Each side of  the link is allowed to provide  a list of
  37.      files to be  sent.  Files will travel simultaneously  in BOTH directions
  38.      until both sides of the link are satisfied.
  39.  
  40.      HS/Link is not just  another bi-directional protocol, it is  also a very
  41.      fast protocol  for normal downloading and  uploading, incorporating some
  42.      new ideas  (such as  Full-Streaming-Error-Correction(tm),  Dynamic-Code-
  43.      Substitution  and Minimal-Blocks(tm)) to make things happen a bit faster
  44.      and with greater reliability.
  45.  
  46.  
  47.         ___________________________________________________________________
  48.  
  49.                                      Copyright
  50.         ___________________________________________________________________
  51.  
  52.      All Tool  Shop(tm) products are  trademarks or registered  trademarks of
  53.      Samuel H. Smith  DBA The Tool Shop.   Other brand and product  names are
  54.      trademarks or registered trademarks of their respective holders.
  55.  
  56.      Copyright (C) 1991, 1992, 1993 Samuel H. Smith
  57.      All rights reserved.
  58.  
  59.  
  60.      HS/Link 1.21                      - 1 -                  Reference Guide
  61.  
  62.  
  63.  
  64.  
  65.         ___________________________________________________________________
  66.  
  67.                                  Table of Contents
  68.         ___________________________________________________________________
  69.  
  70.      Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . .    3
  71.  
  72.      Quick Tour  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  73.  
  74.      Command Line Format . . . . . . . . . . . . . . . . . . . . . . . .    7
  75.  
  76.      HSCONFIG: The HS/Link Configuration Manager . . . . . . . . . . . .    9
  77.  
  78.      HSCONFIG: Basic Settings  . . . . . . . . . . . . . . . . . . . . .   10
  79.  
  80.      HSCONFIG: Advanced COM settings . . . . . . . . . . . . . . . . . .   12
  81.  
  82.      HSCONFIG: Advanced Optional Features  . . . . . . . . . . . . . . .   14
  83.  
  84.      HSCONFIG: Advanced Optional Features 2  . . . . . . . . . . . . . .   16
  85.  
  86.      HSCONFIG: Screen Settings . . . . . . . . . . . . . . . . . . . . .   18
  87.  
  88.      Advanced Command Line Options . . . . . . . . . . . . . . . . . . .   20
  89.  
  90.      Command Line Examples . . . . . . . . . . . . . . . . . . . . . . .   21
  91.  
  92.      Calling HS/Link from COMM programs  . . . . . . . . . . . . . . . .   22
  93.  
  94.      Calling HS/Link from BBS programs . . . . . . . . . . . . . . . . .   22
  95.  
  96.      CHAT During File Transfer . . . . . . . . . . . . . . . . . . . . .   24
  97.  
  98.      Flow Control  . . . . . . . . . . . . . . . . . . . . . . . . . . .   25
  99.  
  100.      Full Streaming Data Transmission  . . . . . . . . . . . . . . . . .   26
  101.  
  102.      Full Streaming Error Recovery . . . . . . . . . . . . . . . . . . .   27
  103.  
  104.      Transmission of Minimal Blocks  . . . . . . . . . . . . . . . . . .   27
  105.  
  106.      Dynamic Code Substitution . . . . . . . . . . . . . . . . . . . . .   28
  107.  
  108.      Auto Downloading  . . . . . . . . . . . . . . . . . . . . . . . . .   29
  109.  
  110.      DSZLOG Statistic Logging  . . . . . . . . . . . . . . . . . . . . .   30
  111.  
  112.      HS/Link Messages  . . . . . . . . . . . . . . . . . . . . . . . . .   31
  113.  
  114.      Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   37
  115.  
  116.      Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   38
  117.  
  118.  
  119.      HS/Link 1.21                      - 2 -                  Reference Guide
  120.  
  121.  
  122.  
  123.  
  124.         ___________________________________________________________________
  125.  
  126.                                    Introduction
  127.         ___________________________________________________________________
  128.  
  129.      What is a file transfer protocol?
  130.  
  131.      A file transfer protocol is a means of transferring information from one
  132.      computer  to another.  The protocol has the responsibility of protecting
  133.      against errors  in transit, and  taking measures to  correct any  errors
  134.      that are detected.  The design and implementation of a protocol can make
  135.      the difference between slow and  unreliable communication, and fast  and
  136.      trouble free communication.
  137.  
  138.      Not all protocols  are created equal.   With today's high speed  modems,
  139.      packet  switched  networks  (such as  PC  Pursuit),  and  expensive long
  140.      distance charges,  users demand more  than ever that  files get  through
  141.      quickly and without corruption.
  142.  
  143.      The  HS/Link protocol  is  the result  of  many years  of  communication
  144.      experience,  and uses some  new and  very solid technology to  see to it
  145.      that  you can  easily move files  as quickly  as possible,  and with the
  146.      least amount of hassle.
  147.  
  148.      The HSLINK  program can be used  from the DOS  command line, from  BATCH
  149.      files, or  as an "external protocol" from most  modern COMM programs and
  150.      BBS  programs.  If  your favorite  BBS does not yet  support the HS/Link
  151.      protocol, please ask your SYSOP to install it.
  152.  
  153.  
  154.      Recent advances in high speed modem technology have   =================
  155.      made it possible to simultaneously transfer data at   === Quick Tip ===
  156.      high speeds in both directions.   This standardized   =================
  157.      technology is  called "V.32"  or "V.32bis",  and is      Bi-directional
  158.      available in many new modems.  Until HS/Link, these       features that
  159.      advanced  modems were  left half  idle, due  to the     really work... 
  160.      single-direction  nature  of  other  file  transfer         HS/Link can
  161.      protocols.    The  bi-directional  capabilities  of      simultaneously
  162.      HS/Link  take  full  advantage  of   these  modems,    send and receive
  163.      cutting  online  time as  much  as  50% when  equal              files!
  164.      amounts of data are transmitted and received.
  165.  
  166.      HS/Link also takes  full advantage of 1200 and 2400  baud modems, giving
  167.      you very nearly the best thru-put such modems are capable of.
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.      HS/Link 1.21                      - 3 -                  Reference Guide
  179.  
  180.  
  181.  
  182.  
  183.         ___________________________________________________________________
  184.  
  185.                               Summary of Key Features
  186.         ___________________________________________________________________
  187.  
  188.      ∙ Speed.
  189.           HS/Link operates at, or  very near peak efficiency,  often reaching
  190.           98%  or more  with  pre-compressed files  and  non-buffered modems.
  191.           Even higher speeds  are possible with buffered or  error correcting
  192.           modems.  A number of features, such as fast  32 bit CRC protection,
  193.           Full-Streaming-Error-Recovery     and    Dynamic-Code-Substitution,
  194.           combine to give maximum performance and security.
  195.  
  196.      ∙ Simple interface for beginners.
  197.           In many cases,  HS/Link requires only the  COM port number and  the
  198.           filename to be transmitted.   Configuration files are not required.
  199.           The  program is easily installed in most COMM programs that support
  200.           external protocols.  The HSLINK program has multiple help  screens,
  201.           providing  a quick reference to the basic and advanced command line
  202.           options, including examples of how the program is used.
  203.  
  204.      ∙ Batch file transfers.
  205.           The protocol can handle any  size batch of files, and can take file
  206.           specifications from either the command line or from a listing file.
  207.  
  208.      ∙ Bi-directional options that really work.
  209.           The  program can simultaneously  upload and download  with a single
  210.           host  request.   What's even  better is  how easy  it is  to use...
  211.           instead of a complex setup all you do is:
  212.  
  213.           1)   Tell the BBS the names of the files you  want to download, and
  214.                then
  215.           2)   Press  PGUP (or  whatever  your COMM  program  uses  to UPLOAD
  216.                files) and then tell your COMM program which files to upload
  217.  
  218.           By virtue of the  BBS being told that it is  sending files and your
  219.           COMM program telling HS/Link that it too is sending files, you then
  220.           have  a bi-directional transfer.   There's nothing else  to set up.
  221.           You use the familiar BBS interface to request files to download and
  222.           your  COMM program's familiar  interface to tell it  which files to
  223.           upload.  It couldn't get easier!
  224.  
  225.      ∙ Aborted file crash recovery.
  226.           When desired, HS/Link can resume an aborted transfer, verifying all
  227.           existing data blocks to insure the resumed file completely  matches
  228.           the file being transmitted.   This function can also  update a file
  229.           that has only a small number of changed, added, or deleted blocks.
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.      HS/Link 1.21                      - 4 -                  Reference Guide
  238.  
  239.  
  240.  
  241.  
  242.         ___________________________________________________________________
  243.  
  244.                                     Quick Tour
  245.         ___________________________________________________________________
  246.  
  247.      If  you are  eager to  see HS/Link  in action,  follow the  simple steps
  248.      below.   The following pages will tell  you how to install and configure
  249.      the HS/Link program for optimal ease of use and performance. 
  250.  
  251.      1.  Unpack the HSLINK  program into a working  directory or your choice.
  252.      All you really need is HSLINK.EXE for now.
  253.  
  254.      2.  Use  the TERMINAL  program of  your  choice to  call up  a  BBS that
  255.      supports the HS/Link protocol.  If you don't know of a BBS in your area,
  256.      you can  always call  the Tool  Shop BBS  at (818)  891-1344 to  see how
  257.      HS/Link works.
  258.  
  259.      3.  When online  with  your  BBS, select  a  DOWNLOAD  using the  HSLINK
  260.      protocol.  
  261.  
  262.      4.  When the  BBS is  ready for  you to  begin, press  the SHELL  TO DOS
  263.      command in your  terminal program.   In many terminal programs,  this is
  264.      the ALT-J command.  Later  you will be given instructions to tie HS/Link
  265.      into  the  DOWNLOAD command,  but for  now  we are  going to  run HSLINK
  266.      manually so you can see it in action right away.
  267.  
  268.      5. CD into the HSLINK working directory you set up in step 1.
  269.  
  270.      6. If your modem is on COM1, type the command
  271.                HSLINK -P1
  272.      If your modem is on COM2, instead use the command
  273.                HSLINK -P2
  274.  
  275.      You should  now  see HS/Link  in action.    If your  copy of  HSLINK  is
  276.      registered, you can press the ENTER key to begin a CHAT session with the
  277.      person  running the BBS.   If  you aren't registered yet,  you can still
  278.      CHAT, but the BBS operator has to start the CHAT for you.
  279.  
  280.      In  this sample session  you aren't doing a  bidirectional transfer, but
  281.      you  to do  so  all  you need  to  do is  add  the outgoing  file  names
  282.      (including drive and directory) to the end of the command line above.
  283.  
  284.      7. When HSLINK finishes, type the command
  285.                EXIT
  286.      to return to your TERMINAL program to continue your BBS session.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.      HS/Link 1.21                      - 5 -                  Reference Guide
  297.  
  298.  
  299.  
  300.  
  301.         ___________________________________________________________________
  302.  
  303.                             Full Screen Status Display
  304.         ___________________________________________________________________
  305.  
  306.      When HS/Link  is operating, it  produces a full  screen status  display,
  307.      divided into five windows.  For example:
  308.   ╒══════════ HS/Link v1.21 (5/06/93) Copyright 1993 Samuel H. Smith ══════════╕
  309.   │ [UNREGISTERED] Courtesy of The Tool Shop BBS (818) 891-1344.               │
  310.   │ Command line: -@tolap.cfg test\*.* -s2048 -w12 -a                          │
  311.   └────────────────────────────────────────────────────────────────────────────┘
  312.   ╒═════════ 5 InComing Files, 710782 bytes ═════════╕ ╒══════ Settings ═══════╕
  313.   │ \TMP\VIROSCAN.ZIP (79 blocks, 161003 bytes)      │ │  COM2 open at: 115200 │
  314.   │ File received OK, 2930 cps, 58 seconds.          │ │Remote Serial#: 00001  │
  315.   │ \TMP\PM.ZIP (37 blocks, 73745 bytes)             │ │Remote Version: 1.10   │
  316.   │ Block 14 (28672 bytes) 2622 cps                  │ │        Window: NONE   │
  317.   │ █████████████░░░░░░░░░░░░░░░░░░░░░░ 18 seconds   │ │    Block size: 2048   │
  318.   └──────────────────────────────────────────────────┘ │      XON/XOFF: ON     │
  319.   ╒════════ 9 OutGoing Files, 2297792 bytes ═════════╕ │ CTS handshake: OFF    │
  320.   │ TEST\PHASE1.EXE (179 blocks, 365810 bytes)       │ │ RTS handshake: OFF    │
  321.   │ File sent OK, 5907 cps, 01:01 minutes.           │ │Slow handshake: ON     │
  322.   │ TEST\PHASE2.EXE (204 blocks, 416884 bytes)       │ │        Resume: OFF    │
  323.   │ Block 20 (40960 bytes/w:20) 5570 cps             │ │  Keep partial: ON     │
  324.   │ ███░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 01:08 minutes│ │     Overwrite: ON     │
  325.   └──────────────────────────────────────────────────┘ └─ ^X^X^X^X to abort! ──┘
  326.   ╒═══════════════════════════════ Batch Status ═══════════════════════════════╕
  327.   │ Total 2047451 bytes (of 3008574) in 04:00 minutes, thruput 8509 cps.       │
  328.   │ ██████████████████████████████████░░░░░░░░░░░░░░░░░ 01:53 minutes remaining│
  329.   └───────────────────────── PLEASE REGISTER HS/LINK! ─────────────────────────┘
  330.  
  331.      The  first window  contains  the program  identification  and copyright.
  332.      When you  register your copy of  HSLINK, this window will  also show the
  333.      registered serial number.  Some warning messages may also appear in this
  334.      window.
  335.  
  336.      The "Settings" window shows a summary of the various parameters that can
  337.      be altered with  command line options.   This display space is  replaced
  338.      with the InComing Chat and OutGoing Chat windows during CHAT operation.
  339.  
  340.      The "InComing  Files" window shows  the status of  files being  received
  341.      from the remote system.
  342.  
  343.      The  "OutGoing Files" window shows the status of files being transmitted
  344.      to the remote system.
  345.  
  346.      The  "Batch  Status"  window  summarizes  overall session  progress  and
  347.      estimates the time remaining for the selected files.
  348.  
  349.      To  stop display bleedthrough  under DesqView or DoubleDOS,  use the -NV
  350.      option to disable  direct video writing.  The result  will be a slightly
  351.      slower display, but it will not bleed from one partition to another.
  352.  
  353.      If desired, the full screen status display can be turned off. 
  354.  
  355.      HS/Link 1.21                      - 6 -                  Reference Guide
  356.  
  357.  
  358.  
  359.  
  360.         ___________________________________________________________________
  361.  
  362.                                 Command Line Format
  363.         ___________________________________________________________________
  364.  
  365.      To  run the HSLINK program,  a command line must be  given.  The command
  366.      line has the following format:
  367.  
  368.      HSLINK [options] [SENDFILE] [@DRIVE:\PATH\FILELIST]
  369.  
  370.      SENDFILE  Indicates  a  list  of  files  to  be  transmitted  to  remote
  371.                computer.   The list  may include the  DOS wildcard characters
  372.                '?' and '*'.  Specify ONLY   files to be transmitted; received
  373.                file names are determined automatically.
  374.  
  375.      @FILELIST Transmit  list  of  files  contained  in  FILELIST  to  remote
  376.                computer.  This is used when  you want to make a long list  of
  377.                files  in advance,  then  transmit  them  all  with  a  single
  378.                command.   It is  also used  by BBS  programs to  produce long
  379.                batches of downloads.
  380.  
  381.      ∙    Anything shown in brackets "[]" is optional and may  not need to be
  382.           specified for proper operation of HS/Link.
  383.  
  384.      ∙    The HSLINK command line is NOT  case sensitive, and will work  when
  385.           typed in upper, lower or mixed case.
  386.  
  387.      ∙    Please make sure that HSLINK.EXE is in a search PATH directory.
  388.  
  389.  
  390.         ___________________________________________________________________
  391.  
  392.                             Basic Command Line Options
  393.         ___________________________________________________________________
  394.  
  395.      The most important command line  options are -P (set COM port),  -U (set
  396.      download file directory), and -HS (enable slow handshake).
  397.  
  398.      -Pport    This sets which COM port you are using.  
  399.                Example:  -P2
  400.  
  401.      -Udir     This  sets  the destination  directory  for downloaded  files.
  402.                Without this option,  all download files  are placed into  the
  403.                current directory.
  404.                Example:  -Uc:\bbsfiles
  405.  
  406.      -HS       Handshake Slow (send  XOFF and/or lower RTS  during disk I/O).
  407.                This  option may  be required  if your  computer is  unable to
  408.                simultaneously access the disk  and the COM port.  If  you see
  409.                frequent CRC  error messages, even  on clean phone  lines, you
  410.                probably need to include -HS in your command line.
  411.  
  412.      To abort an HS/Link transfer, press Control-X four or more times.
  413.  
  414.      HS/Link 1.21                      - 7 -                  Reference Guide
  415.  
  416.  
  417.  
  418.  
  419.         ___________________________________________________________________
  420.  
  421.                                 Configuration Files
  422.         ___________________________________________________________________
  423.  
  424.      Because  of the  large number  of  possible command   =================
  425.      line options, you can store frequently used command   === Quick Tip ===
  426.      options in a  configuration file.   This eliminates   =================
  427.      the  need  to  repeatedly  type  the options  at  a    HS/Link does NOT
  428.      command  line.   If  you  are  calling HSLINK  from             require
  429.      multiple   batch   files,    you   can   also   use       configuration
  430.      configuration files to store "common" options, that              files.
  431.      can be changed in  one place rather than separately
  432.      in the various batch files.
  433.  
  434.      HSLINK  will first search the current directory for   =================
  435.      the HSLINK.CFG  file.  If  not found, it  will then   === Quick Tip ===
  436.      search  the directory  where HSLINK.EXE  is stored,   =================
  437.      followed  by  all  directories  in  the   DOS  PATH   For best results,
  438.      setting. If the HSLINK.CFG file is found, each file    add your HS/Link
  439.      line is loaded as a command line option.                or COMM program
  440.                                                            directory to your
  441.                                                              PATH statement.
  442.      If you want to use an alternate configuration file,
  443.      use  the -@fname  command line  option,  which will
  444.      cause 'fname' to be loaded.  For example:
  445.           HSLINK -@C:\WORK\TOLAP.CFG
  446.      will cause HSLINK to use C:\WORK\TOLAP.CFG as the configuration file.
  447.  
  448.      If -@fname is not the first command  line option, the default HSLINK.CFG
  449.      file  will be searched for and loaded before the specified configuration
  450.      file.
  451.  
  452.      Use  -@ (without  a filename)  to prevent  HSLINK  from searching  for a
  453.      configuration  file, slightly speeding operation on  systems that have a
  454.      long search PATH setting in effect.
  455.  
  456.  
  457.  
  458.      To aid in creation and alteration  of configuration   =================
  459.      files, the HS/Link  Configuration Manager  program,   === Quick Tip ===
  460.      HSCONFIG, was written.                                =================
  461.                                                              Use HSCONFIG to
  462.                                                              create and edit
  463.                                                               HS/Link option
  464.                                                              (configuration)
  465.                                                                       files.
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.      HS/Link 1.21                      - 8 -                  Reference Guide
  474.  
  475.  
  476.  
  477.  
  478.         ___________________________________________________________________
  479.  
  480.                     HSCONFIG: The HS/Link Configuration Manager
  481.         ___________________________________________________________________
  482.  
  483.      HSLINK includes the HS/Link Configuration Manager program, HSCONFIG.EXE.
  484.      With  this  program you  can  easily manipulate  most of  HS/Link's many
  485.      options.
  486.  
  487.      The opening display for HSCONFIG looks like this:
  488.  
  489.   C:\HSL >hsconfig
  490.   HS/Link Configuration Manager 1.2 (C)1993 Samuel H. Smith; ALL RIGHTS RESERVED
  491.  
  492.          ┌────────────────── New Configuration ─────────────────────┐
  493.          │                                                          │
  494.          │ The specified configuration file cannot be located.      │
  495.          │                                                          │
  496.          │ This probably indicates that you are creating a new      │
  497.          │ configuration for HS/Link.  All options will be set      │
  498.          │ to default values.                                       │
  499.          │                                                          │
  500.          │ Alternate configuration files can be specified on        │
  501.          │ the command line to HSCONFIG.  The default configuration │
  502.          │ file is HSLINK.CFG, and it may be located either in the  │
  503.          │ current directory, or in any PATH directory.             │
  504.          │                                                          │
  505.          │ Press <ENTER> or <ESC> to continue.                      │
  506.          │                                                          │
  507.          │  Index  <ESC>                                            │
  508.          └──────────────────────────────────────────────────────────┘
  509.  
  510.   Can't find: C:\UTIL\HSLINK.CFG
  511.  
  512.  
  513.      HSCONFIG  can be used to edit any configuration file, but the default is
  514.      to edit HSLINK.CFG  in the current directory,  or the same directory  in
  515.      which HSLINK.EXE is found.  If you want to edit some other configuration
  516.      file, you must specify the  filename on the HSCONFIG command line.   For
  517.      example:
  518.           HSCONFIG TOLAP.CFG
  519.  
  520.      will create or  edit TOLAP.CFG, which can later be used by HSLINK with a
  521.      command line like this:
  522.           HSLINK -@TOLAP.CFG
  523.  
  524.      When   no  configuration   filename  is   specified,  and   the  default
  525.      configuration file  HSLINK.CFG cannot be located,  it will automatically
  526.      be created in the  same directory that HSLINK.EXE  is found in.   If you
  527.      wish to create the configuration file in a different directory, you must
  528.      explicitly specify  the directory/filename  to be  used on  the HSCONFIG
  529.      command line.
  530.  
  531.  
  532.      HS/Link 1.21                      - 9 -                  Reference Guide
  533.  
  534.  
  535.  
  536.  
  537.         ___________________________________________________________________
  538.  
  539.                              HSCONFIG: Basic Settings
  540.         ___________________________________________________________________
  541.  
  542.      The primary  screen in HSCONFIG  is the "Basic  Settings" screen,  which
  543.      controls the most  important settings for HS/Link operation.   The other
  544.      screens contain  advanced settings that  need not be  changed until  you
  545.      become more familiar with the program and begin to  explore the advanced
  546.      capabilities.
  547.  
  548.    ╒═════════════════ HS/Link: Basic Settings [Page 1 of 5] ══════════════OVR═╕
  549.    │                                                                          │
  550.    │    These are the most important settings for proper HS/Link operation    │
  551.    │                                                                          │
  552.    │  COM port number (1-8) . . . . . . . . . . . 1                           │
  553.    │                                                                          │
  554.    │  Directory for downloaded files. . . . . . . __________________________  │
  555.    │                                                                          │
  556.    │  Use "SLOW HANDSHAKE" during disk I/O. . . . N                           │
  557.    │                                                                          │
  558.    ╘══════════════════════════════════════════════════════════════════════════╛
  559.  
  560.               ┌────────────── Help topic: Welcome! ─────────────────┐
  561.               │ Welcome to the HS/Link Configuration Manager.       │
  562.               │ The easy way to handle HS/Link configuration files. │
  563.               │                                                     │
  564.               │ Use the     keys to select entries on this page.    │
  565.               │ Use the PgUp/PgDn keys to change pages.             │
  566.               │ Press ESC to save changes when you are finished.    │
  567.               │                                                     │
  568.               │ Use the F1 key to get HELP at any prompt.           │
  569.               └─────────────────────────────────────────────────────┘
  570.  
  571.     PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  572.  
  573.      The HSCONFIG program contains context sensitive pop-up help for each and
  574.      every  input prompt.  Simply  press the F1 key  to get an explanation of
  575.      the current entry.  For example:
  576.  
  577.          ┌───────────────────────────── -U ────────────────────────────────┐
  578.          │ -Udir  > Download directory.                                    │
  579.          │                                                                 │
  580.          │ This option controls the destination directory for downloaded   │
  581.          │ files.  Without this option, all download files are placed into │
  582.          │ the current directory.                                          │
  583.          │                                                                 │
  584.          │  Index  <ESC>                                                   │
  585.          └─────────────────────────────────────────────────────────────────┘
  586.  
  587.      When in  the online help system,  press the SPACE and  BACKSPACE keys to
  588.      select from the topics available at the bottom of  the window, and press
  589.      ENTER to select a topic.  Press ESCAPE to return to the prior screen.
  590.  
  591.      HS/Link 1.21                     - 10 -                  Reference Guide
  592.  
  593.  
  594.  
  595.  
  596.      This screen manipulates the following options:
  597.  
  598.      -Pport
  599.           Use COM port 1-8 (default=1).   Standard COM port definitions:
  600.                Channel   I/O Port  Interrupt
  601.                 COM1      0x3F8          4
  602.                 COM2      0x2F8          3
  603.                 COM3      0x3E8          4
  604.                 COM4      0x2E8          3
  605.                 COM5      undefined
  606.                 COM6      undefined
  607.                 COM7      0x2E8          5
  608.                 COM8      0x3E8          5
  609.           Use -PB and -PI instead of -P to define a non-standard COM port.
  610.  
  611.      -Udir
  612.           Destination   directory   for   received   files   (default=current
  613.           directory)
  614.  
  615.      -HS
  616.           Handshake Slow (send XOFF and/or lower RTS during disk I/O).
  617.           The slow handshake  option is available for systems with  slow disk
  618.           access.   Use this if  you get frequent  CRC errors  or COM overrun
  619.           errors  on otherwise clean lines.  The slow handshake option causes
  620.           XOFF to be sent and/or RTS to be lowered  during any disk activity.
  621.           Even  when -HS is active, the HS/Link protocol should transfer data
  622.           very nearly as fast as the slowest part of the link allows.
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.      HS/Link 1.21                     - 11 -                  Reference Guide
  651.  
  652.  
  653.  
  654.  
  655.         ___________________________________________________________________
  656.  
  657.                           HSCONFIG: Advanced COM settings
  658.         ___________________________________________________________________
  659.  
  660.      The  "Advanced COM  Settings"  screen determines  the  settings  of many
  661.      communications related  options.   See the following  section, "Advanced
  662.      Options" for a description of each of these options.
  663.  
  664.    ╒══════════════ HS/Link: Advanced COM Settings [Page 2 of 5] ══════════OVR═╕
  665.    │                                                                          │
  666.    │          These settings control advanced communication features          │
  667.    │                                                                          │
  668.    │  Non-Standard COM base (in HEX, 0 = standard COM port) . . . . . . 0000  │
  669.    │                                                                          │
  670.    │  Non-Standard COM IRQ (1-15, 0 = standard COM port). . . . . . . . 0_    │
  671.    │                                                                          │
  672.    │  COM port open speed (300-115200, 0 = automatic) . . . . . . . . . 0___  │
  673.    │                                                                          │
  674.    │  Effective modem-to-modem speed (0 = same as open speed) . . . . . 0___  │
  675.    │                                                                          │
  676.    │  Enable CTS hardware handshake . . . . . . . . . . . . . . . . . . Y     │
  677.    │                                                                          │
  678.    │  Enable RTS hardware handshake . . . . . . . . . . . . . . . . . . Y     │
  679.    │                                                                          │
  680.    │  Enable XON/XOFF software handshake. . . . . . . . . . . . . . . . Y     │
  681.    │                                                                          │
  682.    │  Enable Carrier Detect checking. . . . . . . . . . . . . . . . . . Y     │
  683.    │                                                                          │
  684.    │  Preserve original time/date stamp on received files . . . . . . . Y     │
  685.    │                                                                          │
  686.    ╘══════════════════════════════════════════════════════════════════════════╛
  687.  
  688.     PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  689.  
  690.  
  691.      This screen manipulates the following options:
  692.  
  693.      -PBbase
  694.           Set  non-standard COM  port base  address.   Base addresses  may be
  695.           specified in either decimal or hex.   Hex addresses must begin with
  696.           $ or  0x.  For example,  -PB1000, -PB$3E8 and -PB0x3E8  all specify
  697.           the same port base address.
  698.  
  699.      -PIirq
  700.           Set  non-standard COM port IRQ level to  1-15.  This option must be
  701.           used when  -PB is used.  IRQ  levels 8-15 are supported  only on AT
  702.           class machines with cascaded interrupt controllers.
  703.  
  704.      -Bbaud
  705.           COM  port opening baud rate 300-115200 (default is the current port
  706.           OPEN speed).
  707.           This option  controls  the speed  at which  the  COM port  will  be
  708.  
  709.      HS/Link 1.21                     - 12 -                  Reference Guide
  710.  
  711.  
  712.  
  713.  
  714.           opened.                                          =================
  715.                                                            === Quick Tip ===
  716.           Normally, the COM port speed can be determined   =================
  717.           from hardware and need not be specified.          Don't use the -B
  718.                                                                option if you
  719.      -Ebaud                                               don't need to!  In
  720.           Effective modem-to-modem baud rate.             most cases HS/Link
  721.           This is used  to estimate transfer  times, and          is able to
  722.           is   included    in   the    DSZLOG    output.   automatically set
  723.           (default=current -B setting)                       the proper port
  724.                                                                       speed.
  725.      -HC
  726.           Disables CTS hardware handshake.
  727.           CTS  transmitter  handshake  is  automatically  enabled,  but   may
  728.           conflict with some  unusual modem cables or  serial ports.  If  the
  729.           CTS signal is  not active when HSLINK loads, it  will automatically
  730.           disable CTS  handshake for you.   Use the  -HC command to  manually
  731.           disable CTS handshake.
  732.  
  733.      -HR
  734.           Disables RTS hardware handshake.
  735.           RTS receiver handshake  is used when  the slow-handshake option  is
  736.           selected.  This form of  handshake causes the RTS line to the modem
  737.           to be lowered  whenever the disk is  being accessed.   Some unusual
  738.           modem or  cable arrangements may  not tolerate the  RTS line  being
  739.           lowered.   In this  case, the RTS  handshake can  be disabled  with
  740.           the -HR option.
  741.  
  742.      -HX
  743.           Disable XON/XOFF handshake.
  744.           XON/XOFF handshake is a software handshake scheme that  should work
  745.           well on all combinations of modems and networks, and is enabled  by
  746.           default.   If you prefer not to use XON/XOFF handshake, or you find
  747.           that it is not required for error-free transfer, you can disable it
  748.           with the -HX option.
  749.  
  750.           Note  that both  the sender  and  the receiver  must simultaneously
  751.           disable XON/XOFF handshake, otherwise it will remain in effect.
  752.  
  753.      -C
  754.           Disable  carrier detect  checking.   Use this option  when directly
  755.           connecting two machines via a null modem cable.
  756.  
  757.      -NT
  758.           Stamp current file time.   This option stamps the current time/date
  759.           on  received   files,  instead  of  retaining   the  original  file
  760.           time/date.
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.      HS/Link 1.21                     - 13 -                  Reference Guide
  769.  
  770.  
  771.  
  772.  
  773.         ___________________________________________________________________
  774.  
  775.                       HSCONFIG: Advanced Optional Features 1
  776.         ___________________________________________________________________
  777.  
  778.      The  "Advanced  Optional  Features  1"  screen  controls  many  advanced
  779.      protocol  features.  See the following section, "Advanced Options" for a
  780.      description of each of these options.
  781.  
  782.    ╒══════════ HS/Link: Advanced Optional Features 1 [Page 3 of 5] ═══════OVR═╕
  783.    │                                                                          │
  784.    │             These settings control various optional features             │
  785.    │                                                                          │
  786.    │  Attempt to Resume aborted transfers . . . . . . . . . . . . . . . N     │
  787.    │                                                                          │
  788.    │  Keep partial files from aborted transfers . . . . . . . . . . . . N     │
  789.    │                                                                          │
  790.    │  Allow received files to overwrite/modify existing files . . . . . N     │
  791.    │                                                                          │
  792.    │  Enable file read/write buffering. . . . . . . . . . . . . . . . . Y     │
  793.    │                                                                          │
  794.    │  Enable "Dynamic-Code-Substitution" logic. . . . . . . . . . . . . Y     │
  795.    │                                                                          │
  796.    │  Size of transmitted data blocks (64-4096 bytes/block) . . . . . . 1024  │
  797.    │                                                                          │
  798.    │  Number of blocks in transit before ACK is required (0-1000) . . . 8___  │
  799.    │                                                                          │
  800.    │  Disable transmission of ACK for each block received . . . . . . . N     │
  801.    │                                                                          │
  802.    │  Force remote unit to use local option settings. . . . . . . . . . N     │
  803.    │                                                                          │
  804.    ╘══════════════════════════════════════════════════════════════════════════╛
  805.  
  806.     PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  807.  
  808.      This screen manipulates the following options:
  809.  
  810.      -R
  811.           Resume  aborted transfer.   The  receiver  and   =================
  812.           transmitter  will  verify  the contents  of an   === Quick Tip ===
  813.           existing file, and  will begin transmission at   =================
  814.           the  first block  that does  not match.   This     Use -R -K -O if
  815.           provides  a  reliable  means of  restarting an   you want Download
  816.           aborted  transfer, or  of updating  a modified      Crash Recovery
  817.           file.  You must also use -O to recover aborted
  818.           downloads.
  819.  
  820.           Note  to BBS operators:  Crash recovery is enabled  by the caller's
  821.           use of -R -K  -O options and should NOT be  directly enabled in the
  822.           BBS command line or configuration file.
  823.  
  824.      -K
  825.           Keep partial files from aborted transfers.
  826.  
  827.      HS/Link 1.21                     - 14 -                  Reference Guide
  828.  
  829.  
  830.  
  831.  
  832.      -O
  833.           Allow receive files to overwrite existing files.
  834.  
  835.      -NB
  836.           Disable buffering of receive and transmit files.  The default is to
  837.           divide approximately  24k of  memory between InComing  and OutGoing
  838.           files.
  839.  
  840.      -NC
  841.           Disable Dynamic-Code-Substitution logic.
  842.           Certain  byte codes  cannot be  transmitted directly  over  the COM
  843.           link. For instance, the codes for Control-X, Control-S and Control-
  844.           Q must be  "escaped" to  prevent a  conflict with  flow or  program
  845.           control.
  846.  
  847.           The HS/Link protocol uses a new Dynamic-Code-Substitution system to
  848.           drastically reduce the number  protocol overhead and "escape" codes
  849.           needed  to transmit certain  data streams.   Highly compressed data
  850.           files  (such as ZIP  and GIF  files) benefit  the most,  since they
  851.           often have many byte codes that cannot be transmitted directly over
  852.           the COM link.
  853.  
  854.      -Ssize
  855.           Sets transmit  block size 2-4096 (default=1024)  Larger block sizes
  856.           may result in higher transfer speeds under clean line conditions.
  857.  
  858.      -Wwindow                                              =================
  859.           Number  of blocks  allowed without  ACK 1-1000   === Quick Tip ===
  860.           (default=8)                                      =================
  861.           Use  -A  or -W0  to  establish  an  "infinite"    Use -W4 -S512 -!
  862.           window (i.e. no ACK required at all).              with PC-Pursuit
  863.  
  864.           The "ACK window" is  the number of blocks that
  865.           will be sent  to the modem before an  ACKnowledge code is required.
  866.           If the specified number of blocks have been sent and no ACK has yet
  867.           been received, output  will be suspended until the ACK  is received
  868.           or  the link  times out.   This  provides a  form of  software flow
  869.           control that  works  well when  parts  of the  link are  very  slow
  870.           compared to other parts, such as when PC Pursuit is in use.
  871.  
  872.           The /w:XXX value displayed in the InComing Files window reports the
  873.           actual  number  of  blocks  that  are being  transmitted  prior  to
  874.           acknowledge.  Setting  the -W value higher than the  highest /w:XXX
  875.           value observed will have no further effect on transfer thru-put.
  876.  
  877.      -A
  878.           Disable  transmission  of ACK  codes  after each  block.   This may
  879.           improve transfer speeds under some conditions. 
  880.  
  881.      -!
  882.           Take priority.  Locally specified -A, -HX, -S, and -W settings will
  883.           be used by the remote system.  The -N! option cancels the effect of
  884.           the -! option.
  885.  
  886.      HS/Link 1.21                     - 15 -                  Reference Guide
  887.  
  888.  
  889.  
  890.  
  891.         ___________________________________________________________________
  892.  
  893.                       HSCONFIG: Advanced Optional Features 2
  894.         ___________________________________________________________________
  895.  
  896.      The  "Advanced  Optional  Features  2"  screen  controls  more  advanced
  897.      protocol  features.  See the following section, "Advanced Options" for a
  898.      description of each of these options.
  899.  
  900.    ╒══════════ HS/Link: Advanced Optional Features 2 [Page 4 of 5] ═══════OVR═╕
  901.    │                                                                          │
  902.    │               These settings control more optional features              │
  903.    │                                                                          │
  904.    │  Idle method (0=none, 1=BIOS, 2=DesqView, 3=DDOS, 4=WIN/OS2) . . . 0     │
  905.    │                                                                          │
  906.    │  Enable "Minimal-Blocks" logic (requires MNP). . . . . . . . . . . N     │
  907.    │                                                                          │
  908.    │  Disable NS16550AN buffering logic . . . . . . . . . . . . . . . . N     │
  909.    │                                                                          │
  910.    │  NS16550 Fifo Threshold (1-15) . . . . . . . . . . . . . . . . . . 4__   │
  911.    │                                                                          │
  912.    │  DSZLOG status logging file. . . . . . . . . __________________________  │
  913.    │                                                                          │
  914.    │  Incoming file duplication check list. . . . U:\PCB\GEN\DLPATH.LST_____  │
  915.    │                                                                          │
  916.    │  Force CTS handshake even when CTS is initially missing. . . . . . N     │
  917.    │                                                                          │
  918.    │  Use Alternate XON/XOFF method during initial handshake. . . . . . Y     │
  919.    │                                                                          │
  920.    │  Maximum number of repeated errors before aborting transfer. . . . 20    │
  921.    │                                                                          │
  922.    ╘══════════════════════════════════════════════════════════════════════════╛
  923.  
  924.     PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  925.  
  926.  
  927.      This screen manipulates the following options:
  928.  
  929.      -Iidle
  930.           This option controls  how idle time is given up  under multitasking
  931.           environments.  The possible values are:
  932.                -I0  Default, do not give up idle time
  933.                -I1  Spend idle time checking keyboard status
  934.                -I2  Give up idle time under DesqView
  935.                -I3  Give up idle time under DoubleDOS
  936.                -I4  Give up idle time under Windows/OS2/VCPI/DOS5
  937.           Some network server software, such as LanTastic, performs best when
  938.           the -I1 option is used.
  939.  
  940.      -NM
  941.           Enable Minimal-Blocks  logic.  Use  with caution.   This option  is
  942.           recommended for use only on error-corrected links, such as with MNP
  943.           or V.42 connections.
  944.  
  945.      HS/Link 1.21                     - 16 -                  Reference Guide
  946.  
  947.  
  948.  
  949.  
  950.      -N5
  951.           This  option causes  HS/Link  to disable  NS16550  buffering logic.
  952.           This  option may be  needed with some early  versions, or incorrect
  953.           clone versions of  the NS16550 chip, which do not  properly perform
  954.           buffering.
  955.  
  956.      -FTn
  957.           Sets NS16550 FIFO Threshold.
  958.           This option controls the number of characters that will be buffered
  959.           by  the  NS16550 internal buffer before an interrupt  is generated.
  960.           Higher FIFO  thresholds will produce fewer  interrupts and somewhat
  961.           less  CPU loading,  but with  the risk  of  overrun errors.   Lower
  962.           thresholds  will prevent  overrun errors  under  multi-taskers like
  963.           Windows or Desqview.
  964.  
  965.      -LFlogfile
  966.           Specify status log file.
  967.           This option allows you to override the DSZLOG environment  variable
  968.           to  specify the  file to  be  used for  status  logging. Omit  this
  969.           option,  or leave blank to control this function through the DSZLOG
  970.           environment variable.
  971.  
  972.      -NOdirlist
  973.           Incoming file duplication checklist.
  974.  
  975.           This option allows you to check incoming files for duplication in a
  976.           list of  directories.   This feature prevents  incoming files  from
  977.           duplicating files in directories other than the current -U setting.
  978.  
  979.           The dirlist is a text file which contains one filename or directory
  980.           specification  per line.    See MKDLIST  documentation  for special
  981.           instructions to speed CD-ROM duplication checking.
  982.  
  983.           Note   that  this  option  is  effective  ONLY  if  the  -O  (allow
  984.           overwrites) is NOT used.
  985.  
  986.      -FC
  987.           Force CTS hardware handshake.
  988.           This  option  prevents  HSLINK  from  automatically  disabling  CTS
  989.           hardware handshake if CTS is not active initially.
  990.  
  991.      -NA
  992.           This  option causes HS/Link  to use the old  XON/XOFF method rather
  993.           than the new alternate method during the initial handshake with the
  994.           remote.   This option  is needed only  if handshake fails  when the
  995.           remote unit is  version 1.12  or earlier and  should not be  needed
  996.           when communicating with newer versions.
  997.  
  998.      -NEn
  999.           Controls the number of repeated errors needed to abort a transfer.
  1000.  
  1001.  
  1002.  
  1003.  
  1004.      HS/Link 1.21                     - 17 -                  Reference Guide
  1005.  
  1006.  
  1007.  
  1008.  
  1009.         ___________________________________________________________________
  1010.  
  1011.                              HSCONFIG: Screen Settings
  1012.         ___________________________________________________________________
  1013.  
  1014.      The "Screen  Settings" screen allows  you to control  the format of  the
  1015.      status  display screen, the colors to be  used, and to enable or disable
  1016.      direct-video screen updates.
  1017.  
  1018.    ╒═══════════════ HS/Link: Screen Settings [Page 5 of 5] ═════════════OVR═╕
  1019.    │                                                                        │
  1020.    │            These settings control the screen format and colors         │
  1021.    │                                                                        │
  1022.    │  Enable Full-Screen status display . . . . . . . . . . . . . . . . Y   │
  1023.    │  Enable direct video writing (turn off in DesqView/DoubleDOS/etc). Y   │
  1024.    │  Position of status display (0-2)  . . . . . . . . . . . . . . . . 2   │
  1025.    │  Color of BORDER in full screen mode . . . . . . . . . . . . . . . 7__ │
  1026.    │  Color of PROMPTS in full screen mode. . . . . . . . . . . . . . . 47_ │
  1027.    │  Color of WINDOW TITLE in full screen mode . . . . . . . . . . . . 79_ │
  1028.    │  Color of WINDOW CONTENTS in full screen mode. . . . . . . . . . . 31_ │
  1029.    │  Color of PROGRESS GRAPHS in full screen mode. . . . . . . . . . . 14_ │
  1030.    │                                                                        │
  1031.    ╘════════════════════════════════════════════════════════════════════════╛
  1032.        ┌── Color Table ───────────────────────────────────────────────────┐
  1033.        │   0   1   2   3   4   5   6   7   8   9  10  11  12  13  14  15  │
  1034.        │  16  17  18  19  20  21  22  23  24  25  26  27  28  29  30  31  │
  1035.        │  32  33  34  35  36  37  38  39  40  41  42  43  44  45  46  47  │
  1036.        │  48  49  50  51  52  53  54  55  56  57  58  59  60  61  62  63  │
  1037.        │  64  65  66  67  68  69  70  71  72  73  74  75  76  77  78  79  │
  1038.        │  80  81  82  83  84  85  86  87  88  89  90  91  92  93  94  95  │
  1039.        │  96  97  98  99 100 101 102 103 104 105 106 107 108 109 110 111  │
  1040.        │ 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127  │
  1041.        └──────────────────────────────────────────────────────────────────┘
  1042.     PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  1043.  
  1044.  
  1045.      This screen manipulates the following options:
  1046.  
  1047.      -NF  Disable Full screen mode.  The standard status   =================
  1048.           display takes over the full screen (except the   === Quick Tip ===
  1049.           top 2  lines, which  may contain a  BBS status   =================
  1050.           line).                                              HS/Link's Full
  1051.                                                                Screen status
  1052.           This option  bypasses the full  screen display    display does not
  1053.           and causes a line-oriented output  to be used.   alter the first 2
  1054.           Use this option  if your environment's  screen  display lines. Use
  1055.           management  does  not   allow  a   full-screen   the -CP option to
  1056.           display.                                                change the
  1057.                                                             position of this
  1058.                                                                     display.
  1059.  
  1060.  
  1061.  
  1062.  
  1063.      HS/Link 1.21                     - 18 -                  Reference Guide
  1064.  
  1065.  
  1066.  
  1067.  
  1068.      -NV                                                   =================
  1069.           Disable direct Video for  DesqView, DoubleDOS,   === Quick Tip ===
  1070.           and etc.   Use  this option if  you experience   =================
  1071.           "bleeding"  of the  status  display  from  one     You may need to
  1072.           partition to another.                              use -NV to stop
  1073.                                                            display bleeding.
  1074.      -CPn
  1075.           Control  the position  of the  status display.
  1076.           Use  a setting of  -CP0 to move  the display UP so  that the bottom
  1077.           lines will be  untouched.  The default is -CP2,  which protects the
  1078.           top 2 lines of the original display.
  1079.  
  1080.      -CBcolor
  1081.           Defines the border color in full screen mode.
  1082.  
  1083.      -CMcolor
  1084.           Defines the main screen color in full screen mode.
  1085.  
  1086.      -CTcolor
  1087.           Defines the window title color in full screen mode.
  1088.  
  1089.      -CWcolor
  1090.           Defines the window contents color in full screen mode.
  1091.  
  1092.      -CGcolor
  1093.           Defines the file  and batch progress bargraph color in  full screen
  1094.           mode.
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.      HS/Link 1.21                     - 19 -                  Reference Guide
  1123.  
  1124.  
  1125.  
  1126.  
  1127.         ___________________________________________________________________
  1128.  
  1129.                            Advanced Command Line Options
  1130.         ___________________________________________________________________
  1131.  
  1132.      The HS/Link  protocol program has  a number of  additional command  line
  1133.      options, most  of which  are rarely  needed, or  which are  provided for
  1134.      advanced users to obtain maximum performance and flexibility.
  1135.  
  1136.      -@
  1137.           When the -@  option is given as the FIRST  parameter on the command
  1138.           line,  it prevents  HSLINK from  performing the  normal search  for
  1139.           HSLINK.CFG,  possibly  speeding   load  times  and  preventing  the
  1140.           accidental loading  of a configuration  file meant for  a different
  1141.           application.
  1142.  
  1143.      -@fname
  1144.           Uses fname  as an alternate configuration  file.  Each  line in the
  1145.           specified  file  may contain  a  single command  line option.   The
  1146.           default is to search PATH directories for HSLINK.CFG.
  1147.  
  1148.      -N!
  1149.           Do  not force  remote to  use local  settings.   Will  override any
  1150.           previous  -! option in  either the command line  or a configuration
  1151.           file.
  1152.  
  1153.      -NG
  1154.           Do not allow  Control-G (BEEP) characters in CHAT mode.  This keeps
  1155.           remote callers from beeping your speaker during a file transfer.
  1156.  
  1157.      -NK
  1158.           Cancels the effect  of the -K option, if present,  to force partial
  1159.           files from aborted transfers to be deleted.
  1160.  
  1161.      -NU
  1162.           Block uploads.    This option  is used by BBS  programs that cannot
  1163.           (yet) cope with bi-directional uploads.  It is used in place of the
  1164.           -U option on  the 'download' command  line, and has  the effect  of
  1165.           blocking any simultaneous upload requests from a user.
  1166.  
  1167.      -T
  1168.           Activates  a  "mini  terminal"  mode  prior to  starting  the  file
  1169.           transfer.  If  used with the -C option, you can use HS/Link to type
  1170.           "AT" commands directly to your modem to dial out.
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.      HS/Link 1.21                     - 20 -                  Reference Guide
  1182.  
  1183.  
  1184.  
  1185.  
  1186.         ___________________________________________________________________
  1187.  
  1188.                                Command Line Examples
  1189.         ___________________________________________________________________
  1190.  
  1191.      HSLINK -?
  1192.           Display a summary of HS/Link command line formats.
  1193.  
  1194.      HSLINK -P1
  1195.           Download from  a  BBS using  HS/Link.   COM1 will  be  used at  the
  1196.           current  port speed.    Received files  will  go into  the  current
  1197.           directory.
  1198.  
  1199.      HSLINK -P2 -Uc:\bbsfiles -K
  1200.           Download  from  a BBS  using HS/Link.    COM2 will  be used  at the
  1201.           current  port speed.   Received files will go  into the c:\bbsfiles
  1202.           directory.  Partial files from aborted transfers will be kept.
  1203.  
  1204.      HSLINK -P1 -Uc:\bbsfiles -R -K -O
  1205.           Continue  an aborted download from a BBS  using HS/Link.  COM1 will
  1206.           be used at the current port speed.  Received files will go into the
  1207.           c:\bbsfiles directory.
  1208.  
  1209.      HSLINK -Uc:\bbsfiles c:\uploads\*.zip
  1210.           Download from  a  BBS using  HS/Link.   COM1 will  be  used at  the
  1211.           current  port speed.   Received files will go  into the c:\bbsfiles
  1212.           directory.  Simultaneously upload all *.ZIP files in the c:\uploads
  1213.           subdirectory.
  1214.  
  1215.      HSLINK file1.zip file2.zip file3.zip
  1216.           Upload to a BBS using  HS/Link.  COM1 will  be used at the  current
  1217.           port speed.  Simultaneously  downloads selected files from the  BBS
  1218.           into the current directory.
  1219.  
  1220.      HSLINK -b115200 -p2 -c -hs -hc -a file1.zip file2.zip
  1221.           Communicate  files with  a laptop  computer using  port COM2  and a
  1222.           three wire null modem cable.
  1223.  
  1224.      HSLINK -w4 -s512 -! -uc:\download
  1225.           Download files through PC-Pursuit using  a window of 4 blocks and a
  1226.           block size of  512 bytes.  This setting stops  most errors when PC-
  1227.           Pursuit is heavily loaded.
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.      HS/Link 1.21                     - 21 -                  Reference Guide
  1241.  
  1242.  
  1243.  
  1244.  
  1245.         ___________________________________________________________________
  1246.  
  1247.                         Calling HS/Link from COMM programs
  1248.         ___________________________________________________________________
  1249.  
  1250.      The  HS/Link  protocol  can  be easily  installed  in  most modern  COMM
  1251.      programs.  Specific  instructions have  been prepared  for many  popular
  1252.      COMM programs, and are available in separate files for download.
  1253.  
  1254.           Comm program             Instructions posted in
  1255.  
  1256.           BOYAN 5.0                HS-BOY50.ZIP
  1257.           GT POWER 15.50           HS-GT15.ZIP
  1258.           ProComm Plus             HS-PCPTD.ZIP
  1259.           ProComm Plus/Windows     HS-PROW.ZIP
  1260.           QMODEM 4.3               HS-QMOD.ZIP
  1261.           ROBO COMM 3.1            HS-RC31.ZIP
  1262.           TELEMATE 2.1             HS-TMATE.ZIP
  1263.           TELIX 3.1                HS-TELIX.ZIP
  1264.  
  1265.      Installation  instructions for new  COMM programs are  being written all
  1266.      the time, so  check with your local  bulletin board or on the  Tool Shop
  1267.      for instructions for additional communication programs.
  1268.  
  1269.  
  1270.         ___________________________________________________________________
  1271.  
  1272.                          Calling HS/Link from BBS programs
  1273.         ___________________________________________________________________
  1274.  
  1275.      The HS/Link protocol can easily be installed in most modern BBS programs
  1276.      as an external  protocol.  Specific instructions have been  prepared for
  1277.      many  popular  BBS programs,  and  are available  in separate  files for
  1278.      download.
  1279.  
  1280.           BBS program              Instructions in         =================
  1281.                                                            === Quick Tip ===
  1282.           GAP 5.1                  HS-GAP51.ZIP            =================
  1283.           MarkMail/GAP             HS-MKML.ZIP                Check The Tool
  1284.           PCBOARD 14.5a            HS-145A.ZIP              Shop BBS for the
  1285.           PROBOARD 1.17            HS-PB117.ZIP            latest version of
  1286.           PRODOOR 3.44             HS-PROD.ZIP             HS-INST.ZIP.  New
  1287.           RemoteAccess 1.11        HS-RA111.ZIP                 COMM and BBS
  1288.           RBBS 17.3C               HS-R173C.ZIP                 programs are
  1289.           Rybbs                    HS-RYBBS.ZIP             frequently added
  1290.           SuperBBS 1.15 G4         HS-S1154.ZIP            to the library of
  1291.           Searchlight BBS          HS-SLBBS.ZIP                      install
  1292.           Spitfire BBS v3.0        HS-SF30.ZIP                  instructions
  1293.           UltraBBS v2.08           HS-UB208.ZIP                   available.
  1294.           Virtual BBS v5.40        HS-VBB54.ZIP
  1295.           Waffle                   HS-WAF.ZIP
  1296.           Wildcat! TD v2.15        HS-WC215.ZIP
  1297.           WWIV v4.20               HS-WWIV.ZIP
  1298.  
  1299.      HS/Link 1.21                     - 22 -                  Reference Guide
  1300.  
  1301.  
  1302.  
  1303.  
  1304.         ___________________________________________________________________
  1305.  
  1306.                                  BBS Requirements
  1307.         ___________________________________________________________________
  1308.  
  1309.      HS/Link's  demands on  a bulletin  board program  are extremely  easy to
  1310.      fill.  The following is all that is necessary:
  1311.  
  1312.      1)   The  protocol  accepts  either  a  filename to   =================
  1313.           download  or  a  list  of  files of  the  form   === Quick Tip ===
  1314.           @DRIVE:\PATH\DOWNLIST.LST.   The protocol will   =================
  1315.           send  only the  specified files  if  filenames     Send file lists
  1316.           (without leading  @) are given, or  all of the      are text files
  1317.           files found in the file C:\BBS\DOWNLIST.LST if    that contain one
  1318.           the option @C:\BBS\DOWNLIST.LST is specified.    path/filename per
  1319.                                                                        line.
  1320.  
  1321.      2)   The  protocol will create  a DSZLOG compatible
  1322.           log file indicating the names  of all files transferred as  well as
  1323.           their status (refer  to the DSZ standard and the  "DSZLOG Statistic
  1324.           Logging" section for the specific contents of the file).
  1325.  
  1326.  
  1327.      3)   Any files  found in the DSZLOG  file which BBS   =================
  1328.           did not tell the  protocol to SEND are assumed   === Quick Tip ===
  1329.           to have instead been RECEIVED by the protocol.   =================
  1330.           The BBS should then check for the existence of    HS/Link does NOT
  1331.           such files and if found, ask for  descriptions   modify BBS upload
  1332.           and post them in the upload directory.           listings! The BBS
  1333.                                                                 program must
  1334.                                                           detect uploads and
  1335.                                                             do it's own file
  1336.                                                                  management.
  1337.  
  1338.  
  1339.  
  1340.  
  1341.      If the BBS program is not yet able to cope with bi-   =================
  1342.      directional uploads, the -NU  option can be used on   === Quick Tip ===
  1343.      the 'download' command line to prevent  attempts to   =================
  1344.      perform a bi-directional upload.                       Use -NU to block
  1345.                                                           all bi-directional
  1346.                                                                     uploads.
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.      HS/Link 1.21                     - 23 -                  Reference Guide
  1359.  
  1360.  
  1361.  
  1362.  
  1363.         ___________________________________________________________________
  1364.  
  1365.                              CHAT During File Transfer
  1366.         ___________________________________________________________________
  1367.  
  1368.      While  you are waiting for files to transfer, you can also type messages
  1369.      to the remote operators screen and see what he types in return.  This is
  1370.      called "CHAT mode".  
  1371.  
  1372.      If your copy  of HSLINK is  registered, you can  press the ENTER  key to
  1373.      begin  a CHAT session  with the person running  the BBS.   If you aren't
  1374.      registered yet,  you can still CHAT,  but the BBS operator  has to start
  1375.      the CHAT for you.
  1376.  
  1377.      Once you activate CHAT, the "Settings" portion of the display is removed
  1378.      and replaced with two new windows:  "InComing Chat" and "OutGoing Chat".
  1379.      Anything you type will appear in the OutGoing Chat display, and anything
  1380.      the remote operator types will appear in your InComing Chat display.  
  1381.  
  1382.      Chat mode features automatic word-wrap and keyboard correction using the
  1383.      backspace key.  
  1384.  
  1385.      You  can  "page" the  remote  user  by  pressing  Control-G  repeatedly.
  1386.      Control-G is the "BELL" character, which causes HSLINK to BEEP.  You can
  1387.      use the -NG command line option to disable  this feature, keeping HSLINK
  1388.      silent.
  1389.  
  1390.      When you  are finished chatting, just  press the ESC key  to restore the
  1391.      Settings  display and  to  terminate  the chat  mode.    Chat mode  will
  1392.      automatically terminate if you type nothing for 30 seconds and all files
  1393.      are finished transferring.
  1394.  
  1395.  
  1396.         ___________________________________________________________________
  1397.  
  1398.                                Optimizing CHAT Mode
  1399.         ___________________________________________________________________
  1400.  
  1401.      The CHAT  mode display may appear  sluggish, or jerky.   This is because
  1402.      HSLINK gives priority to the  file transfer and transmits CHAT text only
  1403.      between whole blocks of the file.   This effect is made worse by the use
  1404.      of large block sizes, especially at low baud rates.
  1405.  
  1406.      If you want  to have snappier chat displays, at  the expense of slightly
  1407.      slower  file transfers,  try  reducing the  BLOCK  SIZE (-S  option)  or
  1408.      setting a smaller ACK WINDOW (-W option).  Try adding 
  1409.           -S256 -W4
  1410.      to your command line, for example.
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.      HS/Link 1.21                     - 24 -                  Reference Guide
  1418.  
  1419.  
  1420.  
  1421.  
  1422.         ___________________________________________________________________
  1423.  
  1424.                                    Flow Control
  1425.         ___________________________________________________________________
  1426.  
  1427.      Flow Control  is required when  the sending and  receiving computers  or
  1428.      modems  operate at  different speeds,  or when  computers are  unable to
  1429.      simultaneously access disk  drives and the COM port.   Flow Control is a
  1430.      software  and/or hardware means of slowing down  the faster parts of the
  1431.      connection to prevent overloading the slower parts of the system.
  1432.  
  1433.      HS/Link uses  both XON/XOFF (software) and  RTS/CTS (hardware) handshake
  1434.      when  communicating  with high  speed  modems  or slow  packet  switched
  1435.      networks.   The protocol also  uses a  window algorithm to  suspend data
  1436.      transmission if the receiver  does not eventually respond to transmitted
  1437.      data.
  1438.  
  1439.      XON/XOFF  handshake is a software handshake scheme that should work well
  1440.      on all combinations of modems  and networks, and is enabled  by default.
  1441.      If you prefer not to use  XON/XOFF handshake, or you find that it is not
  1442.      required  for error-free  transfer,  you can  disable  it with  the  -HX
  1443.      option.   Note that both the sender and the receiver must simultaneously
  1444.      disable XON/XOFF handshake, otherwise it will remain in effect.
  1445.  
  1446.      The slow  handshake option  (-HS) is  available for   =================
  1447.      systems with slow disk access.  Use this if you get   === Quick Tip ===
  1448.      frequent  CRC  errors  or  COM  overrun  errors  on   =================
  1449.      otherwise clean  lines.  The slow  handshake option      The -HS option
  1450.      causes XOFF  to be  sent and/or  RTS to  be lowered  stops most overrun
  1451.      during any disk activity.  Even when -HS is active,      and CRC errors
  1452.      the  HS/Link protocol  should  transfer  data  very   that occur during
  1453.      nearly as  fast as  the  slowest part  of the  link      or immediately
  1454.      allows.                                                  after disk I/O
  1455.                                                                 takes place.
  1456.  
  1457.      CTS transmitter handshake is automatically enabled,
  1458.      but may conflict with some unusual modem cables or serial ports.  If the
  1459.      CTS  signal is  not  active when  HSLINK  loads, it  will  automatically
  1460.      disable  CTS handshake for you.  Use the -HC command to manually disable
  1461.      CTS handshake.
  1462.  
  1463.      RTS  receiver  handshake  is  used  when the  slow-handshake  option  is
  1464.      selected.  This form of handshake causes the RTS line to the modem to be
  1465.      lowered  whenever the  disk is  being accessed.   Some unusual  modem or
  1466.      cable arrangements may not tolerate the RTS line being lowered.  In this
  1467.      case, the RTS handshake can be disabled with the -HR option.
  1468.  
  1469.      If  you have frequent CRC errors or COM overrun errors, which persist in
  1470.      spite of the handshake-slow option (-HS), you should  consider upgrading
  1471.      your serial  port from  the usual  8250 to  a newer, buffered  NS16550AN
  1472.      chip.  The buffered chips are highly recommended if you are operating at
  1473.      high  baud  rates (>9600)  or  are  accessing  extended  memory  or  are
  1474.      multitasking.
  1475.  
  1476.      HS/Link 1.21                     - 25 -                  Reference Guide
  1477.  
  1478.  
  1479.  
  1480.  
  1481.      I have  also had  reports that use  of large numbers  of dos  BUFFERS in
  1482.      CONFIG.SYS can cause  overrun errors.  Try reducing the  BUFFERS setting
  1483.      to 10 or less, especially if you also use a DISK cache.
  1484.  
  1485.      Some  disk cache  programs  have also  been  reported to  cause  overrun
  1486.      errors.  Try turning the cache OFF before calling HSLINK, and turning it
  1487.      back ON again after the transfer is completed.
  1488.  
  1489.  
  1490.  
  1491.         ___________________________________________________________________
  1492.  
  1493.                                Buffered ASYNC chips
  1494.         ___________________________________________________________________
  1495.  
  1496.  
  1497.      The National NS16550AN is  a pin compatible plug in   =================
  1498.      replacement for  8250 and  16450 serial chips.   It   === Quick Tip ===
  1499.      contains  hardware   buffering  to   allow   faster   =================
  1500.      operation  in systems  with high  interrupt service  The NS16550AN chip
  1501.      latency.                                             stops most overrun
  1502.                                                               and CRC errors
  1503.      If  you  have  an  NS16550AN  buffered  UART  chip,    encountered with
  1504.      HS/Link  will  automatically  enable  buffering for    COM port opening
  1505.      better  performance  with  high  speed  modems  and  speeds of 9600 and
  1506.      multi-tasking environments.                                     higher.
  1507.  
  1508.      The  -N5  option  may  be  needed with  some  early
  1509.      versions, or incorrect clone versions  of the NS16550 chip, which do not
  1510.      properly perform buffering.
  1511.  
  1512.  
  1513.  
  1514.         ___________________________________________________________________
  1515.  
  1516.                          Full Streaming Data Transmission
  1517.         ___________________________________________________________________
  1518.  
  1519.      The  HS/Link protocol  allows multiple  data  blocks to  be  transmitted
  1520.      before an acknowledgement  is required by use of block  numbers combined
  1521.      with a window algorithm.
  1522.  
  1523.      The  protocol  also  allows acknowledgements  to be   =================
  1524.      combined   with  data   flowing  in   the  opposite   === Quick Tip ===
  1525.      direction,  making  it  possible  to  achieve  full   =================
  1526.      streaming  simultaneously in both directions over a    The HST modem is
  1527.      full duplex communication link.                         not well suited
  1528.                                                           for bi-directional
  1529.      Even   though  the  transmitters  operate  in  full  transfers.  Switch
  1530.      streaming  mode,   the  receivers   normally   will   to V.32 modes, if
  1531.      periodically  acknowledge   that  data   is   being      available, for
  1532.      received.    This  acknowledgement can  be disabled    higher thru-put.
  1533.      with the -A option.
  1534.  
  1535.      HS/Link 1.21                     - 26 -                  Reference Guide
  1536.  
  1537.  
  1538.  
  1539.  
  1540.      Recent advances in high speed  modem technology have made it possible to
  1541.      simultaneously  transfer data at  high speeds in both  directions.  This
  1542.      standardized technology is called "V.32" or "V.32bis", and are available
  1543.      in many  new modems.   The bi-directional capabilities  of HS/Link  take
  1544.      full advantage of these modems,  cutting online time as much as 50% when
  1545.      equal amounts of data are transmitted and received.
  1546.  
  1547.      Some  older high speed modems, such  as the HST and   =================
  1548.      Hayes-V,  do not  implement  V.32 and  are  able to   === Quick Tip ===
  1549.      transfer quickly in only  one direction, while  the   =================
  1550.      other direction  is relatively slow.   HS/Link will     The "Ping Pong"
  1551.      still  perform well as a  single direction protocol    effect slows bi-
  1552.      with these modems, but bi-directional thru-put will         directional
  1553.      be low due  to the "ping pong" effect of  the modem  transfers on older
  1554.      switching the high speed channel back and forth.      9600 baud modems.
  1555.  
  1556.  
  1557.  
  1558.         ___________________________________________________________________
  1559.  
  1560.                            Full Streaming Error Recovery
  1561.         ___________________________________________________________________
  1562.  
  1563.      The  HS/Link  protocol  has  the unique  ability  to  recover from  many
  1564.      transmission errors without breaking out of full streaming mode.
  1565.  
  1566.      This  is important with buffered modems or packet switched networks with
  1567.      long turnaround times.
  1568.  
  1569.      Conventional  protocols,  such  as  Zmodem,  simply   =================
  1570.      reposition   the   transmitter   after   an  error,   === Quick Tip ===
  1571.      requiring  a   re-transmission  of  not   only  the   =================
  1572.      erroneous data, but also  the entire stream of data    Error correction
  1573.      that was  in transit  at  the time  the  error  was    cannot stop flow
  1574.      detected.                                              control failure-
  1575.                                                              related errors.
  1576.      The HS protocol can  correct bad blocks without re-        See the Flow
  1577.      transmitting intermixed good  blocks, resulting  in  Control section if
  1578.      excellent transfer speeds under moderate line noise            you have
  1579.      conditions.                                          persistent errors.
  1580.  
  1581.  
  1582.  
  1583.         ___________________________________________________________________
  1584.  
  1585.                           Transmission of Minimal Blocks
  1586.         ___________________________________________________________________
  1587.  
  1588.      The  HS/Link  protocol  includes a  Minimal Blocks  feature,  which when
  1589.      activated, causes the protocol  to strip away repeated information  from
  1590.      the  protocol frames and transmit only the minimal amount of information
  1591.      required for data flow.
  1592.  
  1593.  
  1594.      HS/Link 1.21                     - 27 -                  Reference Guide
  1595.  
  1596.  
  1597.  
  1598.  
  1599.      This feature results  in a savings  of over 50%  of   =================
  1600.      the  normal protocol  overhead  characters  in each   === Quick Tip ===
  1601.      block of data, while retaining full data integrity.   =================
  1602.      All data and control  blocks are fully protected by     Enable Minimal-
  1603.      a 32 bit CRC  calculation, even when Minimal Blocks     Blocks with the
  1604.      is in effect.                                        -NM option only if
  1605.                                                            you are operating
  1606.      The final block  in a file rarely ends on  an exact  with an error free
  1607.      transfer  block  boundary.    The  HS/Link protocol               link.
  1608.      automatically shortens the final block, eliminating
  1609.      extraneous data transmission at the end of file.
  1610.  
  1611.  
  1612.  
  1613.         ___________________________________________________________________
  1614.  
  1615.                              Dynamic Code Substitution
  1616.         ___________________________________________________________________
  1617.  
  1618.      Certain byte  codes cannot be  transmitted directly over  the COM  link.
  1619.      For instance, the  codes for Control-X, Control-S and Control-Q  must be
  1620.      "escaped" to prevent a conflict with flow or program control.
  1621.  
  1622.      The  HS/Link protocol  uses a  new Dynamic  Code Substitution  system to
  1623.      drastically reduce number protocol overhead and "escape" codes needed to
  1624.      transmit certain data streams.
  1625.  
  1626.      Highly compressed  data files (such  as ZIP and  GIF files) benefit  the
  1627.      most, since they  often have many byte codes  that cannot be transmitted
  1628.      directly over the COM link.
  1629.  
  1630.      The Dynamic Code Substitution feature can be disabled, if you wish, with
  1631.      the -NC option.
  1632.  
  1633.  
  1634.  
  1635.         ___________________________________________________________________
  1636.  
  1637.                                Network Compatibility
  1638.         ___________________________________________________________________
  1639.  
  1640.      All  file processing  is fully network  and "share"   =================
  1641.      compatible.    HSLINK can  be  easily  installed in   === Quick Tip ===
  1642.      multi-user or networked computers.  This works with   =================
  1643.      DOS version 3.0 and later.                                      HS/Link
  1644.                                                                automatically
  1645.      When  transmitting a  file, the  file is  opened in        enables file
  1646.      "allow read, deny none" mode.                        sharing in network
  1647.                                                                environments.
  1648.      If  a  file  sharing  violation  is  detected  when
  1649.      opening a  file, control is passed  to the system's
  1650.      current  "critical  error"  handler.   To  automate  recovery  from file
  1651.      sharing  violations,  you  can  install  my FATAL14.ZIP  program,  which
  1652.  
  1653.      HS/Link 1.21                     - 28 -                  Reference Guide
  1654.  
  1655.  
  1656.  
  1657.  
  1658.      automatically retrys  after sharing violations, and keeps a detailed log
  1659.      of all critical errors in a system.
  1660.  
  1661.      Files transmitted  or received with HS/Link retain  their original exact
  1662.      size and time/date stamp.   No extra data is  added beyond EOF, as  with
  1663.      older  protocols.   The current  date/time will  be stamped  on incoming
  1664.      files  if the  -NT  option  is used.    Otherwise,  the original  file's
  1665.      time/date stamp will be retained.
  1666.  
  1667.      When run under  DOS 2.x, HSLINK automatically reverts to  non-share file
  1668.      modes.
  1669.  
  1670.  
  1671.  
  1672.         ___________________________________________________________________
  1673.  
  1674.                                  Auto Downloading
  1675.         ___________________________________________________________________
  1676.  
  1677.      It  is  possible  for  some  terminal  programs  to   =================
  1678.      support  HS/Link  auto  downloading  by   means  of   === Quick Tip ===
  1679.      "scripts"   which  wait  for  the  HS/Link  "ready"   =================
  1680.      packet, and  then shell out to  the HSLINK receiver  With HS/Link Auto-
  1681.      protocol.                                            Download you don't
  1682.                                                              have to hit any
  1683.      This capability is currently active when HS/Link is  additional keys to
  1684.      installed  in  Telix  1.2,  Telemate,  Qmodem  Pro,  execute the HSLINK
  1685.      {COMMO}, BOYAN 5.0, any may be available soon under             driver.
  1686.      many  other  terminal  programs as  the  respective
  1687.      authors  add the  capability to  recognize external
  1688.      protocol signon signatures.
  1689.  
  1690.      The  HS/Link  "ready" packet  is  repeated at  10 second  intervals when
  1691.      waiting for  the  HSLINK receiver  to be  started.   The  format of  the
  1692.      "ready" packet is:
  1693.           "HS*" ^B 
  1694.      or in hex,
  1695.           0x48 0x53 0x2a 0x02
  1696.  
  1697.      When this sequence of characters is received during a terminal 
  1698.      session, the HSLINK protocol should be executed.
  1699.  
  1700.           NOTE:  To  perform   a  bi-directional   transfer  with   Auto
  1701.           Downloading  active, you simply omit the final "CR" you key to
  1702.           the BBS  and instead allow HSLINK  to send then  when you have
  1703.           finished specifying  outgoing file names.   Otherwise the auto
  1704.           download will take  control before you have a chance  to enter
  1705.           outgoing (upload) file names into your comm program.
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.      HS/Link 1.21                     - 29 -                  Reference Guide
  1713.  
  1714.  
  1715.  
  1716.  
  1717.         ___________________________________________________________________
  1718.  
  1719.                              DSZLOG Statistic Logging
  1720.         ___________________________________________________________________
  1721.  
  1722.      When you define the environment variable DSZLOG, the HSLINK program will
  1723.      enable transfer  logging to  the specified filename.   The log  file can
  1724.      also be set with the -FL option.  For example, the AUTOEXEC statement:
  1725.           SET DSZLOG=C:\LOGS\LOG.OUT
  1726.      will cause  HSLINK to log  files transmitted to  C:\LOGS\LOG.OUT.   This
  1727.      form of logging  provides compatibility with programs  that are designed
  1728.      to operate with DSZ or other DSZLOG-type protocols.
  1729.  
  1730.      The  log  file  consists  of  a  single  line  of  text  for  each  file
  1731.      transferred.  Here are some sample log entries:
  1732.  
  1733.   h 227596 10100 bps 1138 cps   0 errors   112 2316 V:\UPLOAD\ZLABP_13.ZIP 0
  1734.   H 177901 10100 bps 1116 cps   1 errors     0  749 U:\PLAY1\ECOMM22.ZIP 0
  1735.   h  16155 10100 bps 1061 cps   0 errors     4  795 W:\ULW\WINROACH.ZIP 0
  1736.   L 136991 10100 bps    0 cps   0 errors    55 1823 W:\ULW\WINDE223.ZIP 11
  1737.   E 152614 10100 bps    0 cps  14 errors    22   38 W:\ULW\CLPGR21C.ZIP 0 2
  1738.  
  1739.      Each line contains the following fields:
  1740.  
  1741.      Size Description
  1742.  
  1743.      1    "H"=file received from remote
  1744.           "h"=file sent to remote
  1745.           "E"=file receive was aborted
  1746.           "e"=file transmit was aborted
  1747.           "L"=lost carrier during file receive
  1748.           "l"=lost carrier during file transmit
  1749.  
  1750.      7    The length  of the file, in bytes.    If the  transfer was aborted,
  1751.           this  field will contain the number of bytes transferred before the
  1752.           transfer was aborted.
  1753.      6    The effective modem-to-modem connect speed.
  1754.      4    Literally " bps"
  1755.      5    The average transfer rate, in characters per second.
  1756.      4    Literally " cps"
  1757.      4    The total number of blocks which required retransmission during the
  1758.           transfer.
  1759.      7    Literally " errors"
  1760.      6    The number of flow control restrictions.
  1761.      5    The length of the last block transferred in the file.
  1762.      ?    The full pathname of the file which was transferred.
  1763.      ?    The Serial Number of the remote HSLINK, if registered.  
  1764.           Otherwise 0.
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.      HS/Link 1.21                     - 30 -                  Reference Guide
  1772.  
  1773.  
  1774.  
  1775.  
  1776.         ___________________________________________________________________
  1777.  
  1778.                                  HS/Link Messages
  1779.         ___________________________________________________________________
  1780.  
  1781.      Bad ____ CRC
  1782.           These messages  indicate that an  error was detected  in a  control
  1783.           message between the  sender and the receiver.  All  control packets
  1784.           are protected by a 32 bit CRC calculation to  provide highly secure
  1785.           and reliable communication.
  1786.  
  1787.      Bad data CRC (#)
  1788.      Dropped bytes -# (#)
  1789.      Noise burst # (#)
  1790.           These messages indicate  that an error was  detected in a block  of
  1791.           data  in the file  being received.  "Dropped  bytes" indicates that
  1792.           some expected  bytes did not  arrive, and  "Noise burst"  indicates
  1793.           that  more bytes  than  expected  arrived.    Error  correction  is
  1794.           automatic, because  of Full-Streaming-Error-Correction,  may  occur
  1795.           without breaking the stream of data being received.
  1796.  
  1797.           If  this message occurs at regular intervals,  it is a sign of flow
  1798.           control failure.   In  most cases, this  can be corrected  with the
  1799.           addition of the -HS command line option.
  1800.  
  1801.      COM#: Break! Framing! Overrun! Parity!
  1802.           These  messages indicate that  an error was detected  in the serial
  1803.           port receiver.   Framing and  Parity errors often  indicate a  baud
  1804.           rate (-B) mismatch.   Overrun errors usually indicate the  need for
  1805.           flow  control or for an upgrade to a buffered serial chip.  Overrun
  1806.           errors  can often be reduced or eliminated  with the use of the -HS
  1807.           command line option.
  1808.  
  1809.      Can't create file '___'
  1810.           This indicates that the  received file could not be  created.  This
  1811.           usually  indicates that the  directory specified in  the -U command
  1812.           line option is invalid, or that the disk is full.
  1813.  
  1814.      Carrier lost!
  1815.           This indicates that Carrier detect was dropped, aborting the HSLINK
  1816.           session.   If  your connection  does not  provide a  carrier detect
  1817.           signal, you can disable this check with the -C command line option.
  1818.           This is often  required when directly  connecting two computers  by
  1819.           means of a "null modem" cable.
  1820.  
  1821.      Disk write failure!  (#)
  1822.           This  usually  indicates that  the  disk is  full and  that further
  1823.           downloads cannot be received.
  1824.  
  1825.      File received OK, # cps, # seconds.
  1826.           The file  was received  correctly and is  now closed.   The average
  1827.           transfer speed  is calculated  based on  the elapsed  time  between
  1828.           receiving  the file  open packet  and the  last byte  of the  file.
  1829.  
  1830.      HS/Link 1.21                     - 31 -                  Reference Guide
  1831.  
  1832.  
  1833.  
  1834.  
  1835.           Transfer speeds are  calculated using the DOS timer tick,  which is
  1836.           not accurate for  transfers taking less than 1 minute  to complete.
  1837.           For very short transfers, a cps rating of 9999 will be returned.
  1838.  
  1839.      File sent OK, # cps, # seconds.
  1840.           The file was  transmitted correctly and is now closed.  The average
  1841.           transfer speed  is calculated  based on  the elapsed  time  between
  1842.           sending the first byte of the file and the last byte of the file.
  1843.  
  1844.      File skipped by remote!
  1845.           The transmitter prints this  message when the receiver requests the
  1846.           current  file be skipped.   This usually happens  when the receiver
  1847.           detects  a  duplicate filename  and  is  not allowed  to  overwrite
  1848.           existing files.
  1849.  
  1850.      File was incomplete!  (# #)
  1851.           This  message indicates that  the transfer was aborted  in some way
  1852.           before  the  specified  file  was  completely received.    Normally
  1853.           incomplete files are erased from disk, but they will be retained of
  1854.           the -K command line option is used.
  1855.  
  1856.      Flow control released (#### t:# r:#)
  1857.           If  output flow has  been suspended by either  software or hardware
  1858.           flow control for more than 15 seconds, the program will assume that
  1859.           there has been a failure of flow control and  will release the hold
  1860.           so data can continue.  The codes in parenthesis indicate which flow
  1861.           controls were  active at  the time (C=CTS  was down,  T=transmitter
  1862.           XOFF  was pending,  R=receiver XOFF  was pending,  A=transmitter is
  1863.           currently  active)  and the  counts  of bytes  in the  transmit and
  1864.           receive holding queues.
  1865.  
  1866.      Handshake: CTS XON/XOFF SLOW ALT
  1867.           This  message indicates  the  current combination  of  flow control
  1868.           options  that are  in  effect.   CTS  indicates CTS  hardware  flow
  1869.           control is active.  XON/XOFF indicates that  XON/XOFF software flow
  1870.           control is  active.  SLOW  indicates that flow  will be  restrained
  1871.           during disk I/O to prevent overrun errors.  ALT indicates  that the
  1872.           alternate XON/XOFF method is being used.
  1873.  
  1874.      HS/Link finished! (t:# r:#) Exit code = #
  1875.           When HSLINK terminates, it sets the DOS ERRORLEVEL to the specified
  1876.           value.    This can  be  checked  in  batch files  to  detect  error
  1877.           conditions.  The following ERRORLEVEL codes are possible:
  1878.  
  1879.           ERRORLEVEL     Reason for link termination
  1880.  
  1881.              0           One or more files transferred successfully
  1882.              1           ^X typed at local keyboard
  1883.              2           ^X received over COM port
  1884.              3           Incompatible BETA versions
  1885.              4           No files transmitted or received
  1886.              5           Remote did not respond within 2 minutes
  1887.              6           Too many framing errors, possible -B mismatch
  1888.  
  1889.      HS/Link 1.21                     - 32 -                  Reference Guide
  1890.  
  1891.  
  1892.  
  1893.  
  1894.              7           Possible tampering or corruption in HSLINK.EXE
  1895.              8           Possible tampering or corruption in HSLINK.EXE
  1896.              9           COM port not responding, incorrect -P options
  1897.             10           Carrier lost during initial handshake with remote
  1898.             11           Link aborted due to CTS lockup
  1899.             12           Bad command line option
  1900.             13           Excessive repeated errors
  1901.  
  1902.           COMM  and  BBS programs  should  use  the  DSZLOG  output  file  to
  1903.           determine more specific details of transfer results.
  1904.  
  1905.           The  (t:# r:#) display  indicates the number  of files successfully
  1906.           transmitted and received.
  1907.  
  1908.      Not allowed to overwrite existing file '___'
  1909.           This  indicates that a file was received but there was another file
  1910.           with the same  name already in the download file directory.  Either
  1911.           erase the  duplicate file, or use  the -O option  to allow existing
  1912.           files to be overwritten.
  1913.  
  1914.      Insufficient memory to load program.
  1915.      Not enough memory!
  1916.           There  was  not enough  memory  available  to  run  HSLINK.    Free
  1917.           additional  memory  by  removing  "TSR"  software,  device drivers,
  1918.           ramdisks or  disk caches.  If  your COMM program has  the option of
  1919.           swapping  to  DISK or  EMS,  enable the  option to  free additional
  1920.           memory for  HSLINK's use.   Current beta copies  of HSLINK  require
  1921.           about 64k  of RAM, but  the specific amount  of memory required  is
  1922.           subject to change from beta to beta.  You can reduce  the amount of
  1923.           memory required if you use  the -NB command line option  to disable
  1924.           file buffering.
  1925.  
  1926.      Out of sequence # (#)
  1927.           This  indicates  that  the  received  block  was out  of  sequence,
  1928.           indicating  that  a  block  was  possibly  missed  or  lost  during
  1929.           transmission.    The  receiver  will  request  the  transmitter  to
  1930.           retransmit the missing block(s).
  1931.  
  1932.      Read failure at #
  1933.           This indicates  that there  was a disk  error reading a  file being
  1934.           transmitted.
  1935.  
  1936.      Receive timeout (#)
  1937.      ACK timeout, resend #
  1938.           This message indicates that it has been too long since the receiver
  1939.           responded to data transmission.  The last data block is repeated in
  1940.           an attempt to wake up the receiver.
  1941.  
  1942.      Received block # (# bytes) # cps
  1943.           This  displays the current status of  the file being received.  The
  1944.           current number of blocks and bytes received is displayed after each
  1945.           block is received.  The estimated transfer  speed in ch/sec is also
  1946.           displayed.
  1947.  
  1948.      HS/Link 1.21                     - 33 -                  Reference Guide
  1949.  
  1950.  
  1951.  
  1952.  
  1953.      Received block # (# bytes) E#
  1954.           When "E#" is  displayed following the received block #  message, it
  1955.           indicates  that  error  recovery  is  in  progress,  and  that  the
  1956.           specified block  number was  in error and  is in  transit from  the
  1957.           transmitter.   When the erroneous block has been received correctly
  1958.           the E# display  will advance to the next erroneous block number, or
  1959.           will be erased if no more erroneous blocks are pending.
  1960.  
  1961.      Received block # (# bytes) R
  1962.           When  "R" is displayed  following the received block  # message, it
  1963.           indicates that current block has been previously received correctly
  1964.           and  is  therefore a  "repeat"  block.   Repeat blocks  occur under
  1965.           severe error conditions and are usually corrected automatically.
  1966.  
  1967.      Receiving file: ___ (# blocks, # bytes)
  1968.           This message indicates that  a new file is being received  from the
  1969.           transmitter.  The file size is displayed in blocks and bytes.
  1970.  
  1971.      Remote not responding!
  1972.           This  indicates that the remote computer did not execute HSLINK and
  1973.           establish  a connection within the two minute timeout period.  This
  1974.           message  could also  indicate  that the  wrong  com port  is  being
  1975.           selected,  or that  the port  is configured improperly  (wrong port
  1976.           speed or IRQ setting).
  1977.  
  1978.      Resending block #
  1979.           This message indicates that the receiver has detected an  erroneous
  1980.           block  and is  requesting a  re-transmission  to correct  the data.
  1981.           Data flow continues where it left off prior to the resend, allowing
  1982.           error recovery to take place without breaking out of full streaming
  1983.           mode and without discarding data that is already in  transit to the
  1984.           receiver.  This is the basis of Full-Streaming-Error-Correction.
  1985.  
  1986.      Restarting current file
  1987.           This  indicates that the receiver was unable to recover from errors
  1988.           encountered in  processing the current file  being transmitted, and
  1989.           has requested that the file be started again from scratch.
  1990.  
  1991.      Seek from block # to #
  1992.           Under the most  severe error conditions,  the receiver may  request
  1993.           the transmitter to discard data that is  in transit to the receiver
  1994.           and  to  rewind to  an  earlier position  in  the  file and  resume
  1995.           transmission.
  1996.  
  1997.      Sending block # (# bytes/w:#) # cps
  1998.           This  is  the   normal  status  display  while  a  file   is  being
  1999.           transmitted.  The  message indicates the latest block number  to be
  2000.           transmitted,  and  in parenthesis  indicates  the  number of  bytes
  2001.           transmitted and  the  current  number  of  blocks  that  have  been
  2002.           transmitted without acknowledgement,  which represents the  size of
  2003.           the transmit  "window" that  is currently  in use.   If  this value
  2004.           hangs  at the current -W setting, you  may benefit from a higher -W
  2005.           setting on the command line.  The estimated transfer  speed is also
  2006.  
  2007.      HS/Link 1.21                     - 34 -                  Reference Guide
  2008.  
  2009.  
  2010.  
  2011.  
  2012.           reported in ch/sec.
  2013.  
  2014.      Sending file: ___ (# blocks, # bytes)
  2015.           This message indicates that a new file is being transmitted  to the
  2016.           receiver.  The file size is displayed in blocks and bytes.
  2017.  
  2018.      Transfer aborted!
  2019.           This  message  indicates that  the current  file transfer  has been
  2020.           aborted  for some  reason.   The specific  reason for  the transfer
  2021.           abort is usually also printed on the screen.
  2022.  
  2023.      Waiting for remote.
  2024.           This message indicates that HSLINK is waiting to handshake with the
  2025.           remote computer.   HSLINK will  wait for  60 seconds for  the other
  2026.           computer to come online; after that the transfer is aborted.   This
  2027.           message can  also  indicate that  you  don not  have the  COM  port
  2028.           correctly specified  or that a non-standard  COM port configuration
  2029.           may be required.
  2030.  
  2031.      Warning: CTS signal missing!  -HC will be assumed.
  2032.           The CTS hardware handshake is normally enabled by default.  If,  on
  2033.           initial  loading,  HSLINK finds  that  the CTS  signal is  down, it
  2034.           assumes that  the current hardware  configuration is not  using CTS
  2035.           handshake and automatically disables further  CTS handshake checks.
  2036.           Use the -HC command line to manually disable CTS handshake.
  2037.  
  2038.      Window: #
  2039.           This  indicates the actual number of  blocks that are allowed to be
  2040.           in transit without  acknowledgement.  This is controlled by  the -W
  2041.           parameter,  and may  be overridden  by the  remote computer  if the
  2042.           remote uses the -!  (take priority) option.
  2043.  
  2044.      Window: NONE
  2045.           This  indicates that the -A command line option has been specified,
  2046.           and  that  the transmitter  is  required  to continue  indefinitely
  2047.           without  receiving any  kind of  acknowledgement from  the receiver
  2048.           that data is being received correctly.
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.      HS/Link 1.21                     - 35 -                  Reference Guide
  2067.  
  2068.  
  2069.  
  2070.  
  2071.         ___________________________________________________________________
  2072.  
  2073.                              License and Registration
  2074.         ___________________________________________________________________
  2075.  
  2076.      This program is  not free!  You are hereby licensed  to use this program
  2077.      for a trial period  of 30 days free of  charge.  If, after  30 days, you
  2078.      decide that you would like  to continue using HSLINK, you  must complete
  2079.      the  registration form (REGISTER.FRM)  and return it to  the author with
  2080.      the required registration fee enclosed.
  2081.  
  2082.      Registration  removes the "UNREGISTERED"  messages as  well as  all time
  2083.      delays and enables  you to initiate a  CHAT session.   Your registration
  2084.      number will be broadcast to the remote copy of hslink.
  2085.  
  2086.      Basic HSLINK registration  costs $20 US,  which includes a  registration
  2087.      certificate showing a Serial Number and Password.  The latest version of
  2088.      HSLINK is available on disk.  A nicely typeset and bound reference guide
  2089.      is also available.  Please print out  the file REGISTER.FRM for specific
  2090.      registration details. 
  2091.  
  2092.      Please feel free  to distribute unregistered HSLINK to your  friends and
  2093.      local BBSs as long  as all of the files in this archive are included and
  2094.      unmodified.
  2095.  
  2096.      Send your registration payment to:
  2097.                          SAMUEL H.  SMITH
  2098.                          P. O. BOX 4808
  2099.                          PANORAMA CITY, CA 91412-4808
  2100.                          U.S.A.
  2101.  
  2102.      HS/Link registration can also be ordered ON LINE by credit card  through
  2103.      any of the Tool Shop BBS phone lines.
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.         ___________________________________________________________________
  2110.  
  2111.                    License Agreement for Shareware distributors
  2112.         ___________________________________________________________________
  2113.  
  2114.      Shareware distributors may distribute this program as long as the author
  2115.      has been  notified, in  writing, prior  to ANY  distribution.   The "per
  2116.      disk" charge may  not exceed $6 and  the shareware distributor  will not
  2117.      change the  above license fee for the end user of HSLINK.  End users are
  2118.      not  exempt  from  registering  HSLINK with  the  author  at the  normal
  2119.      registration fee.
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.      HS/Link 1.21                     - 36 -                  Reference Guide
  2126.  
  2127.  
  2128.  
  2129.  
  2130.         ___________________________________________________________________
  2131.  
  2132.                                       Support
  2133.         ___________________________________________________________________
  2134.  
  2135.      HS/Link was Written by Samuel H. Smith.   Contact me at:
  2136.  
  2137.                The Tool Shop BBS
  2138.  
  2139.                Phone number   Modem type
  2140.                (818) 891-1344 v.32bis/v.42bis
  2141.                (818) 891-6780 v.32bis/v.42bis FREE LINE
  2142.                (818) 891-3772 USR HST 9600
  2143.  
  2144.      You will always find the  latest release version of HS/Link on  the Tool
  2145.      Shop, as well as a variety of support files and programs.
  2146.  
  2147.      HS/Link  is also  supported  by  a  number  of  authorized  distributors
  2148.      throughout  the world.    Please refer  to  DISTRIB.DOC for  the  latest
  2149.      distributor list.
  2150.  
  2151.      The HS/Link Support Conference is carried by UN'I-Net/US, SmartNet, RIME
  2152.      and  possibly a  number of  other  echo networks.   You  can  get direct
  2153.      product support through a local BBS that carries this echo conference.
  2154.  
  2155.      Voice  support is available  tuesday through friday between  9am and 6pm
  2156.      pacific time at (818) 891-4228.
  2157.  
  2158.  
  2159.  
  2160.  
  2161.         ___________________________________________________________________
  2162.  
  2163.                                     Disclaimer
  2164.         ___________________________________________________________________
  2165.  
  2166.      IN NO EVENT WILL  I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST
  2167.      PROFITS,  LOST  SAVINGS OR  OTHER  INCIDENTAL  OR CONSEQUENTIAL  DAMAGES
  2168.      ARISING OUT  OF YOUR USE  OR INABILITY  TO USE THE  PROGRAM, OR  FOR ANY
  2169.      CLAIM BY ANY OTHER PARTY.
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.      HS/Link 1.21                     - 37 -                  Reference Guide
  2185.  
  2186.  
  2187.  
  2188.  
  2189.         ___________________________________________________________________
  2190.  
  2191.                                        Index
  2192.         ___________________________________________________________________
  2193.  
  2194.      Aborting a transfer (7)
  2195.      Auto-download (29)
  2196.      Basic settings (9)
  2197.      Configuration files
  2198.           HSCONFIG (8)
  2199.           specifying alternate configuration files (8)
  2200.      Context sensitive help (10)
  2201.      Crash recovery
  2202.           -R (14)
  2203.      DesqView
  2204.           -I2 (16)
  2205.           -NV (19)
  2206.      Display bleeding (6)
  2207.      DoubleDOS
  2208.           -I3 (16)
  2209.           -NV (19)
  2210.      DSZLOG (30)
  2211.      ERRORLEVEL (32)
  2212.      Errors
  2213.           -HS (7)
  2214.           COM Overrun (11), (25)
  2215.      Exit codes (32)
  2216.      File sharing (28)
  2217.      Flow control (24), (25)
  2218.           -HS (7)
  2219.      HSCONFIG (8)
  2220.      HST (27)
  2221.      Installation
  2222.           In BBS programs (22)
  2223.           In COMM programs (22)
  2224.      Non-standard COM ports (12)
  2225.      NS16550AN (26)
  2226.      Options
  2227.           -! (15)
  2228.           -@ (8)
  2229.           -@fname (20)
  2230.           -A (15)
  2231.           -Bbaud (12)
  2232.           -C (13)
  2233.           -CBcolor (19)
  2234.           -CGcolor (19)
  2235.           -CMcolor (19)
  2236.           -CP (19)
  2237.           -CTcolor (19)
  2238.           -CWcolor (19)
  2239.           -Ebaud (13)
  2240.           -FC (17)
  2241.           -FT (17)
  2242.  
  2243.      HS/Link 1.21                     - 38 -                  Reference Guide
  2244.  
  2245.  
  2246.  
  2247.  
  2248.           -HC (13)
  2249.           -HR (13)
  2250.           -HS (7), (11)
  2251.           -HX (13)
  2252.           -Iidle (16)
  2253.           -K (14)
  2254.           -LFlogfile (17)
  2255.           -N! (20)
  2256.           -N5 (17)
  2257.           -NA (17)
  2258.           -NB (15)
  2259.           -NC (15)
  2260.           -NF (18)
  2261.           -NG (20)
  2262.           -NK (20)
  2263.           -NM (16)
  2264.           -NOdirlist (17)
  2265.           -NT (13)
  2266.           -NU (20)
  2267.           -NV (6), (19)
  2268.           -O (15)
  2269.           -PBbase (12)
  2270.           -PIirq (12)
  2271.           -Pport (7), (11)
  2272.           -R (14)
  2273.           -Ssize (15)
  2274.           -T (20)
  2275.           -Udir (7), (11)
  2276.           -Wwindow (15)
  2277.      PC-Pursuit
  2278.           -W (15)
  2279.           Example (21)
  2280.      Registration (36)
  2281.      Support (37)
  2282.      V.32 (27)
  2283.      Zmodem (27)
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.      HS/Link 1.21                     - 39 -                  Reference Guide
  2303.  
  2304.